{ "componentChunkName": "component---src-templates-article-js", "path": "/guides/tuto-upgrade-edixit-db-mysql57-mysql8 ", "result": {"data":{"asciidoc":{"html":"

Tutorial Installation MySQL 5.7 sur CentOS

\n
\n
\n
\n

Ce tutorial permet d’installer une base de données MySQL 5.7 sur un environnement Centos 7.7\nL’installation se fait manuellement de bout en bout.

\n
\n
\n

On suppose que le volume logique sur lequel doit être installé mysql (le disque externe) est sur un point de\nmontage appelé /data/db ou /data.

\n
\n
\n

Notez que dans notre exemple, MySQL sera installé dans /data/db/mysql.

\n
\n
\n\n\n\n\n\n
\n
Tip
\n		\nLe point de montage doit être /data/db ou /data pour ne pas se retrouver avec un répertoire lost+found au milieu\ndes données de MySQL, typiquement /data/db/mysql/lost+found. La situation serait gênante\ncar MySQL croirait que c’est un schema…​\n
\n
\n
\n

On part d’une installation CentOS vierge. Testé sur une instance Amazon CentOS Linux 7 x86_64 (ami-0b850cf02cc00fdc8)

\n
\n
\n
\n
\n

Préalable

\n
\n
\n

SELinux

\n
\n

Par simplicité, nous supposons que SELinux est disabled.\nVous pouvez vérifier si SELinux est activé avec la commande sestatus et modifier la propriété dans /etc/selinux/config\npour le passer à disabled.

\n
\n
\n

Si vous souhaitez garder SELinux, pensez à ajouter les permissions nécéssaires au répertoire\n/data/db/mysql que nous allons créer (mêmes permissions que /var/lib/mysql)

\n
\n
\n
\n
ls -Z /var/lib\ndrwxr-x--x. mysql   mysql   system_u:object_r:mysqld_db_t:s0 mysql
\n
\n
\n
\n
\n

Disques externes

\n
\n

Installation des disques externes sur un point de montage /data dans un contexte AWS.

\n
\n
\n\n\n\n\n\n
\n
Tip
\n		\nvous pouvez passer à la suite si vous gérez vos disques autrement. Notez que l’on ne fait pas de montage LVM\ndans le cadre de ce tutorial. Un montage LVM est préféré en production (pour permettre au disque d’être étendu)\n
\n
\n
\n
\n
# voir les disques\nlsblk\n# vérifier qu'il n'y a rien sur le disque (dans notre cas, le disque s'appelle /dev/xvdb)\nfile -s /dev/xvdb\n# si le resultat est /dev/xvdb: data, c'est que le disque est vide\n# formater le disque\nmkfs -t ext4 /dev/xvdb\n# monter le disque\nmkdir /data\nmount /dev/xvdb /data/\n# vérifier la taille\ncd /data\ndf -h .\n# faire un backup de la fstab\ncp /etc/fstab /etc/fstab.bak
\n
\n
\n
\n

Ouvrir le fichier fstab et ajouter le disque avec par exemple, la ligne suivante

\n
\n
\n
\n
/dev/xvdb   /data   ext4    defaults,nofail 0   0
\n
\n
\n
\n

et monter le tout

\n
\n
\n
\n
mount -a
\n
\n
\n
\n
\n
\n
\n

Installation

\n
\n
\n

Enlever les packages postfix pour eviter les conflits potentiels

\n
\n
\n
\n
sudo yum remove postfix
\n
\n
\n
\n

Répondre oui aux questions posées

\n
\n
\n

Enlever les packages mariadb_libs pour eviter les conflits potentiels :

\n
\n
\n
\n
sudo yum remove mariadb-libs
\n
\n
\n
\n

Répondre oui aux questions posées

\n
\n
\n

Vérifier la version du serveur

\n
\n
\n
\n
cat /etc/centos-release
\n
\n
\n
\n

Ce qui vous donnera par exemple : CentOS Linux release 7.6.1810 (Core).

\n
\n
\n

Allez voir sur le site https://dev.mysql.com/downloads/repo/yum/ quel est le repository qui correspond à votre version de CentOS

\n
\n
\n

Installer yum-utils pour avoir yum-config-manager

\n
\n
\n
\n
yum install yum-utils
\n
\n
\n
\n

Outils complémentaires

\n
\n
\n
\n
yum install wget\nyum install vim
\n
\n
\n
\n

Telecharger le repository yum en fonction de ce que vous avez trouvé dans le repository.

\n
\n
\n
\n
wget https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm\nyum install mysql80-community-release-el7-3.noarch.rpm
\n
\n
\n
\n

Valider la clé hash

\n
\n
\n
\n
md5sum mysql80-community-release-el7-3.noarch.rpm
\n
\n
\n
\n

Le resultat de cette commande doit etre le meme que le hash defini pour ce repository sur le site\nhttps://dev.mysql.com/downloads/repo/yum/

\n
\n
\n

L’installation par defaut pour ce repo est mysql8.0 on peut redefinir la version installée en desactivant mysql8 via\nl’outil yum-config-manager et en activant l’install de mysql5.7 avec la commande.

\n
\n
\n\n\n\n\n\n
\n
Tip
\n		\nEdixit fonctionne sous MYSQL 8 aussi. Des réglages additionnels peuvent être nécéssaires mais sont hors scope de\nce document\n
\n
\n
\n
\n
yum-config-manager --disable mysql80-community\nyum-config-manager --enable mysql57-community
\n
\n
\n
\n

Verifiez que la version activée est bien la version desirée (on peut se tromper facilement et il n’y a pas de warning)

\n
\n
\n
\n
yum repolist enabled | grep mysql
\n
\n
\n
\n

Le resultat de cette commande doit ressembler à ça :

\n
\n
\n
\n
mysql-connectors-community/x86_64 MySQL Connectors Community                 118\nmysql-tools-community/x86_64      MySQL Tools Community                       95\nmysql57-community/x86_64          MySQL 5.7 Community Server                 364
\n
\n
\n
\n

Installer mysql

\n
\n
\n
\n
yum install mysql-server
\n
\n
\n
\n

Dire oui a toutes les questions

\n
\n
\n
\n
\n

Configuration

\n
\n
\n

Calculer la taille de l’espace innodb nécéssaire : https://scalegrid.io/blog/calculating-innodb-buffer-pool-size-for-your-mysql-server/

\n
\n
\n

Quelques exemples :

\n
\n
\n
\n
prod\t8Gb RAM\t6G\nrecette\t4Gb RAM\t2G\nsandbox\t2Gb RAM\t1280
\n
\n
\n
\n\n\n\n\n\n
\n
Tip
\n		\nune bonne pratique consiste à ce que la Timezone de MySQL soit TOUJOURS UTC quelle que soit la Timezone\ndu host sur lequel MySQL est installé.\n
\n
\n
\n

Par défaut, MySQL utilise la Timezone du host sur lequel il fonctionne. Si la Timezone retournée est\nUTC, vous n’avez rien à faire. Si la timezone retournée est Europe/Paris par exemple, il faudra forcer la\ntimezone à UTC dans le fichier de configuration my.cnf de MySQL.

\n
\n
\n

Vérifier la timezone de la VM.

\n
\n
\n
\n
timedatectl
\n
\n
\n
\n

Ouvrir le fichier /etc/my.cnf et y ajouter les lignes de configuration suivantes dans la section server.

\n
\n
\n
\n
# mettre la bonne taille en fonction de ce que vous avez calculé\ninnodb_buffer_pool_size=1280M\nexpire_logs_days=7\n# si vous devez forcer la Timezone à UTC\ndefault-time-zone=+00:00\nslow_query_log=1\n# permet à MYSQL de ne pas planter lorsqu'un utilisateur met des emojis dans les champs textes...\ncharacter-set-server=utf8mb4\ncollation-server=utf8mb4_unicode_520_ci
\n
\n
\n
\n

Dans le même fichier changer datadir et socket aussi en fonction de vos répertoires d’installation

\n
\n
\n
\n
datadir=/data/db/mysql\nsocket=/data/db/mysql/mysql.sock
\n
\n
\n
\n

À la fin du fichier ajouter une section client pour configurer la ligne de commande MySQL cette fois.

\n
\n
\n
\n
[client]\nport=3306\nsocket=/data/db/mysql/mysql.sock
\n
\n
\n
\n

Déplacer le répertoire d’install de mysql dans /data/db/mysql

\n
\n
\n
\n
mkdir -p /data/db/mysql\nchown mysql: /data/db/mysql
\n
\n
\n
\n

Normalement si MySQL n’a pas été démarré avant, cette opération est inutile car /var/lib/mysql/ doit être vide. Mais au cas où :

\n
\n
\n
\n
mv /var/lib/mysql/* /data/db/mysql/
\n
\n
\n
\n
\n
\n

1er Démarrage

\n
\n
\n

Démarrer le service

\n
\n
\n
\n
systemctl start mysqld
\n
\n
\n
\n

Recuperer le mot de passe generé

\n
\n
\n
\n
sudo grep 'temporary password' /var/log/mysqld.log
\n
\n
\n
\n
\n
2019-09-30T16:15:58.834744Z 1 [Note] A temporary password is generated for root@localhost: qwwEdoqyw6&j
\n
\n
\n
\n

Se connecter à mysql avec ce mot de passe

\n
\n
\n
\n
mysql -u root -p
\n
\n
\n
\n

Changer le mot de passe

\n
\n
\n
\n
ALTER USER 'root'@'localhost' IDENTIFIED BY 'votre_nouveau_mot_de_passe';
\n
\n
\n
\n

Stocker le mot de passe dans votre vault ou votre Keepass.

\n
\n
\n

Quitter mysql et se reconnecter avec le nouveau mot de passe pour vérifier que la connexion est valide et le\nmot de passe fonctionne.

\n
\n
\n

En profiter pour verifier la timezone avec la commande

\n
\n
\n
\n
SELECT @@GLOBAL.time_zone, @@SESSION.time_zone;
\n
\n
\n
\n

et ensuite

\n
\n
\n
\n
select now();
\n
\n
\n
\n

Et constater que la date renvoyée est bien en UTC (une heure ou deux de décalage selon la période de l’année avec votre montre si vous êtes en France)

\n
\n
\n
\n
\n

Base de données Edixit

\n
\n
\n

Créer la base de donnée edixit et y ajouter un utilisateur.

\n
\n
\n
\n
CREATE DATABASE edixit;\nCREATE USER 'edixit'@'%' IDENTIFIED BY 'votre_mot_de_passe_special_edixit';\nGRANT ALL PRIVILEGES ON edixit.* TO 'edixit'@'%' WITH GRANT OPTION;
\n
\n
\n
\n

Tenter de s’y connecter avec cet utilisateur depuis une autre machine qui a accès à cet host (typiquement depuis le\nhost de votre serveur d’application edixit_app).

\n
\n
\n
\n
\n

Backups

\n
\n
\n\n\n\n\n\n
\n
Tip
\n		\nIl est très largement conseillé de ne pas utiliser mysqldump pour faire des backups mais utiliser une solution\nprofessionnelle qui sait faire des backups à chaud. Voir https://dev.mysql.com/doc/refman/8.0/en/backup-methods.html .\nUne solution type Percona ou MySQL Entreprise est fortement recommandée.\n
\n
\n
\n

Créer un user pour les backups avec tous les droits sur toutes les tables (voir les procédures ci-dessus)

\n
\n
\n

Créer un fichier /root/.my.cnf avec une section spéciale pour mysqldump

\n
\n
\n
\n
[mysqldump]\nuser=<userDeBackup>\npassword=<passwordUserDeBackup>
\n
\n
\n
\n

Créer le répertoire des backups /data/db/backups et le script mysql-db-backups.sh (n’oubliez pas le chmod u+x\npour le rendre executable).

\n
\n
\n

Notez que nous n’utilisons pas l’option --databases pour ne pas forcer le nom\ndu schema dans le dump (et pouvoir faire une restore sous un autre nom).

\n
\n
\n

Il n’y a pas de triggers dans edixit, mais il y a des routines, veillez donc à ce que l’option --routines soit présente.

\n
\n
\n
\n
#!/bin/sh\nstamp=$(date \"+%y-%m-%d-%H-%M\")\n/usr/bin/mysqldump --single-transaction --hex-blob --routines edixit | gzip -9 > /data/db/backups/edixit-backup-${stamp}.sql.gz
\n
\n
\n
\n

Tester le script une fois et voir le backup réalisé

\n
\n
\n

Mettre en crontab : créer un fichier /etc/cron.daily/mysqldump

\n
\n
\n
\n
0 1 * * * /data/db/backups/mysql-db-backup.sh
\n
\n
\n
\n
","document":{"title":"Tutorial Installation MySQL 5.7 sur CentOS"}}},"pageContext":{"id":"87ec0a18-1116-5b56-ac83-72f4e9fc45bc"}}, "staticQueryHashes": ["1586626695"]}